尺寸|守护者_Android开源框架ImageLoader详解

篇首语：本文由编程笔记#小编为大家整理，主要介绍了Android开源框架Image-Loader详解相关的知识，希望对你有一定的参考价值。

如果说评价一下哪个图片开源库最被广泛使用的话&＃xff0c;我想应该可以说是Universal-Image-Loader&＃xff0c;在主流的应用中如

果你随便去反编译几个&＃xff0c;基本都能看到他的身影&＃xff0c;它就像个图片加载守护者&＃xff0c;默默的守护着图片加载。相信很多人对

这个异步加载图片框架还不是很熟&＃xff0c;再加上最近它更改优化了好几个地方&＃xff0c;而网上的大部分资料还是以前的&＃xff0c;于是花

了几天时间专门的研究了下开源框架Universal-Image-Loader&＃xff08;实际上是近期项目刚好用到&＃xff0c;且仔细的考虑过各种情

况&＃xff09;&＃xff0c;希望对新手能有所帮助&＃xff0c;也希望大神能指点下。

 

 

 

一、功能特性&＃xff1a;

1、多线程异步加载和显示图片&＃xff08;图片来源于网络、sd卡、assets文件夹&＃xff0c;drawable文件夹&＃xff08;不能加载9patch&＃xff09;&＃xff0c;新增加载视频缩略图&＃xff09;

 

http://site.com/image.png // from Web
file:///mnt/sdcard/image.png // from SD card
file:///mnt/sdcard/video.mp4 // from SD card (video thumbnail)
content://media/external/images/media/13 // from content provider
content://media/external/video/media/13 // from content provider (video thumbnail)
assets://image.png // from assets
drawable:// &＃43; R.drawable.img // from drawables (non-9patch images)

 

2、支持通过“listener”监视加载的过程&＃xff0c;可以暂停加载图片&＃xff0c;在经常使用的ListView、GridView中&＃xff0c;可以设置滑动时暂

停加载&＃xff0c;停止滑动时加载图片&＃xff08;便于节约流量&＃xff0c;在一些优化中可以使用&＃xff09;

3、缓存图片至内存时&＃xff0c;可以更加高效的工作

4、高度可定制化&＃xff08;可以根据自己的需求进行各种配置&＃xff0c;如&＃xff1a;线程池&＃xff0c;图片下载器&＃xff0c;内存缓存策略等&＃xff09;

5、支持图片的内存缓存&＃xff0c;SD卡&＃xff08;文件&＃xff09;缓存

6、在网络速度较慢时&＃xff0c;还可以对图片进行加载并设置下载监听

 

二、配置详解

1、下载jar包放在libs文件夹中

注&＃xff1a;Maven dependency:

 


com.nostra13.universalimageloader
universal-image-loader
1.9.3


 

Gradle dependency:

 

compile &＃39;com.nostra13.universalimageloader:universal-image-loader:1.9.3&＃39;

 

2、androidManifest.xml





3、在应用中配置ImageLoaderConfiguration参数&＃xff08;只能配置一次&＃xff0c;如多次配置&＃xff0c;则默认第一次的配置参数&＃xff09;

a、使用默认设置

 

ImageLoaderConfiguration configuration &＃61; ImageLoaderConfiguration.createDefault(this);

 

b、自己配置参数

 

File cacheDir &＃61; StorageUtils.getCacheDirectory(context); //缓存文件夹路径
ImageLoaderConfiguration config &＃61; new ImageLoaderConfiguration.Builder(context)
.memoryCacheExtraOptions(480, 800) // default &＃61; device screen dimensions 内存缓存文件的最大长宽
.diskCacheExtraOptions(480, 800, null) // 本地缓存的详细信息(缓存的最大长宽)&＃xff0c;最好不要设置这个
.taskExecutor(...)
.taskExecutorForCachedImages(...)
.threadPoolSize(3) // default 线程池内加载的数量
.threadPriority(Thread.NORM_PRIORITY - 2) // default 设置当前线程的优先级
.tasksProcessingOrder(QueueProcessingType.FIFO) // default
.denyCacheImageMultipleSizesInMemory()
.memoryCache(new LruMemoryCache(2 * 1024 * 1024)) //可以通过自己的内存缓存实现
.memoryCacheSize(2 * 1024 * 1024) // 内存缓存的最大值
.memoryCacheSizePercentage(13) // default
.diskCache(new UnlimitedDiscCache(cacheDir)) // default 可以自定义缓存路径
.diskCacheSize(50 * 1024 * 1024) // 50 Mb sd卡(本地)缓存的最大值
.diskCacheFileCount(100) // 可以缓存的文件数量
// default为使用HASHCODE对UIL进行加密命名&＃xff0c; 还可以用MD5(new Md5FileNameGenerator())加密
.diskCacheFileNameGenerator(new HashCodeFileNameGenerator())
.imageDownloader(new BaseImageDownloader(context)) // default
.imageDecoder(new BaseImageDecoder()) // default
.defaultDisplayImageOptions(DisplayImageOptions.createSimple()) // default
.writeDebugLogs() // 打印debug log
.build(); //开始构建


配置好ImageLoaderConfiguration&＃xff0c;一定不要忘记进行初始化操作&＃xff08;一般在application中进行初始化&＃xff09;

 

 

ImageLoader.getInstance().init(config);
注&＃xff1a;上面的配置请根据自己的需要进行配置&＃xff0c;不是所有的都要进行配置的

 

 

4、图片显示操作

a、首先要得到ImageLoader的实例(使用的单例模式)

 

ImageLoader imageLoader &＃61; ImageLoader.getInstance();

 

注&＃xff1a;在每个显示任务&＃xff08;布局中都需实例化才能进行相关操作

b、相关显示参数配置

 

DisplayImageOptions options &＃61; new DisplayImageOptions.Builder()
.showImageOnLoading(R.drawable.ic_stub) // 设置图片下载期间显示的图片
.showImageForEmptyUri(R.drawable.ic_empty) // 设置图片Uri为空或是错误的时候显示的图片
.showImageOnFail(R.drawable.ic_error) // 设置图片加载或解码过程中发生错误显示的图片
.resetViewBeforeLoading(false) // default 设置图片在加载前是否重置、复位
.delayBeforeLoading(1000) // 下载前的延迟时间
.cacheInMemory(false) // default 设置下载的图片是否缓存在内存中
.cacheOnDisk(false) // default 设置下载的图片是否缓存在SD卡中
.preProcessor(...)
.postProcessor(...)
.extraForDownloader(...)
.considerExifParams(false) // default
.imageScaleType(ImageScaleType.IN_SAMPLE_POWER_OF_2) // default 设置图片以如何的编码方式显示
.bitmapConfig(Bitmap.Config.ARGB_8888) // default 设置图片的解码类型
.decodingOptions(...) // 图片的解码设置
.displayer(new SimpleBitmapDisplayer()) // default 还可以设置圆角图片new RoundedBitmapDisplayer(20)
.handler(new Handler()) // default
.build();

 

注&＃xff1a;如果DisplayImageOption没有传递给ImageLoader.displayImage(…)方法&＃xff0c;那么从配置默认显示选项
(ImageLoaderConfiguration.defaultDisplayImageOptions(…))将被使用。

 

 

1&＃xff09;.imageScaleType(ImageScaleType imageScaleType) //设置图片的缩放方式
缩放类型mageScaleType:
EXACTLY :图像将完全按比例缩小的目标大小
EXACTLY_STRETCHED:图片会缩放到目标大小完全
IN_SAMPLE_INT:图像将被二次采样的整数倍
IN_SAMPLE_POWER_OF_2:图片将降低2倍&＃xff0c;直到下一减少步骤&＃xff0c;使图像更小的目标大小
NONE:图片不会调整
2&＃xff09;.displayer(BitmapDisplayer displayer) //设置图片的显示方式
显示方式displayer&＃xff1a;
RoundedBitmapDisplayer&＃xff08;int roundPixels&＃xff09;设置圆角图片
FakeBitmapDisplayer&＃xff08;&＃xff09;这个类什么都没做
FadeInBitmapDisplayer&＃xff08;int durationMillis&＃xff09;设置图片渐显的时间
SimpleBitmapDisplayer()正常显示一张图片

 

参数补充:

 

.considerExifParams(true) //是否考虑JPEG图像EXIF参数&＃xff08;旋转&＃xff0c;翻转&＃xff09;
.displayer(new FadeInBitmapDisplayer(100))// 图片加载好后渐入的动画时间

 

c、显示图片

 

1、 ImageLoader.getInstance().displayImage(uri, imageView);
2、 ImageLoader.getInstance().displayImage(uri, imageView, options);
3、 ImageLoader.getInstance().displayImage(uri, imageView, listener);
4、 ImageLoader.getInstance().displayImage(uri, imageView, options, listener);
5、 ImageLoader.getInstance().displayImage(uri, imageView, options, listener, progressListener);

 

 

参数解析&＃xff1a;

 

imageUrl 图片的URL地址
imageView 显示图片的ImageView控件
options DisplayImageOptions配置信息
listener 图片下载情况的监听
progressListener 图片下载进度的监听

 

1)方法1:最简单的方式&＃xff0c;我们只需要定义要显示的图片的URL和要显示图片的ImageView。这种情况下&＃xff0c;图片的显示选项会使用默认的配置

2)方法2:加载自定义配置的一个图片

3)方法3:加载带监听的一个图片

4)方法4:加载自定义配置且带监听的一个图片

5)方法5:加载自定义配置且带监听和进度条的一个图片

 

ImageLoader.getInstance().displayImage(uri, imageView, options,
new ImageLoadingListener()
&＃64;Override
public void onLoadingStarted(String arg0, View arg1)
//开始加载

&＃64;Override
public void onLoadingFailed(String arg0, View arg1,
FailReason arg2)
//加载失败

&＃64;Override
public void onLoadingComplete(String arg0, View arg1,
Bitmap arg2)
//加载成功

&＃64;Override
public void onLoadingCancelled(String arg0, View arg1)
//加载取消

, new ImageLoadingProgressListener()
&＃64;Override
public void onProgressUpdate(String imageUri, View view,
int current, int total)
//加载进度

);

 

三、提示和技巧

1、只有在你需要让Image的尺寸比当前设备的尺寸大的时候&＃xff0c;你才需要配置maxImageWidthForMemoryCach(...)和

maxImageHeightForMemoryCache(...)这两个参数&＃xff0c;比如放大图片的时候。其他情况下&＃xff0c;不需要做这些配置&＃xff0c;因为默

认的配置会根据屏幕尺寸以最节约内存的方式处理Bitmap。

2、在设置中配置线程池的大小是非常明智的。一个大的线程池会允许多条线程同时工作&＃xff0c;但是也会显著的影响到UI

线程的速度。但是可以通过设置一个较低的优先级来解决&＃xff1a;当ImageLoader在使用的时候&＃xff0c;可以降低它的优先级&＃xff0c;这

样UI线程会更加流畅。在使用List的时候&＃xff0c;UI 线程经常会不太流畅&＃xff0c;所以在你的程序中最好设置threadPoolSize(...)和

threadPriority(...)这两个参数来优化你的应用。

3、memoryCache(...)和memoryCacheSize(...)这两个参数会互相覆盖&＃xff0c;所以在ImageLoaderConfiguration中使用一个就好了

4、diskCacheSize(...)、diskCache(...)和diskCacheFileCount(...)这三个参数会互相覆盖&＃xff0c;只使用一个

注&＃xff1a;不要使用discCacheSize(...)、discCache(...)和discCacheFileCount(...)这三个参数已经弃用

5、如果你的程序中使用displayImage&＃xff08;&＃xff09;方法时传入的参数经常是一样的&＃xff0c;那么一个合理的解决方法是&＃xff0c;把这些选项

配置在ImageLoader的设置中作为默认的选项&＃xff08;通过调用defaultDisplayImageOptions(...)方法&＃xff09;。之后调用

displayImage(...)方法的时候就不必再指定这些选项了&＃xff0c;如果这些选项没有明确的指定给

defaultDisplayImageOptions(...)方法&＃xff0c;那调用的时候将会调用UIL的默认设置。

 

四、注意事项

1、如果你经常出现oom&＃xff0c;你可以尝试:

1)禁用在内存中缓存cacheInMemory(false)&＃xff0c;如果oom仍然发生那么似乎你的应用程序有内存泄漏&＃xff0c;使用MemoryAnalyzer来检测它。否则尝试以下步骤(尝试所有或几个)

2)减少配置的线程池的大小(.threadPoolSize(...))&＃xff0c;建议1~5

3)在显示选项中使用 .bitmapConfig(Bitmap.Config.RGB_565) . RGB_565模式消耗的内存比ARGB_8888模式少两倍.

4)配置中使用.diskCacheExtraOptions(480, 320, null)

5)配置中使用 .memoryCache(newWeakMemoryCache()) 或者完全禁用在内存中缓存(don&＃39;t call .cacheInMemory()).

6)在显示选项中使用.imageScaleType(ImageScaleType.EXACTLY) 或 .imageScaleType(ImageScaleType.IN_SAMPLE_INT)

7)避免使用 RoundedBitmapDisplayer. 调用的时候它使用ARGB-8888模式创建了一个新的Bitmap对象来显示&＃xff0c;对于内存缓存模式 (ImageLoaderConfiguration.memoryCache(...)) 你可以使用已经实现好的方法.

2、ImageLoader是根据ImageView的height&＃xff0c;width确定图片的宽高

3、一定要对ImageLoaderConfiguration进行初始化,否则会报错

4、开启缓存后默认会缓存到外置SD卡如下地址(/sdcard/Android/data/[package_name]/cache).如果外置SD卡不存在&＃xff0c;会缓存到手机. 缓存到Sd卡需要在AndroidManifest.xml文件中进行如下配置

 

 

5、内存缓存模式可以使用以下已实现的方法 (ImageLoaderConfiguration.memoryCache(...))

1)缓存只使用强引用

LruMemoryCache (缓存大小超过指定值时&＃xff0c;删除最近最少使用的bitmap) --默认情况下使用

2)缓存使用弱引用和强引用

 

UsingFreqLimitedMemoryCache (缓存大小超过指定值时,删除最少使的bitmap)
LRULimitedMemoryCache (缓存大小超过指定值时,删除最近最少使用的bitmap) --默认值
FIFOLimitedMemoryCache (缓存大小超过指定值时,按先进先出规则删除的bitmap)
LargestLimitedMemoryCache (缓存大小超过指定值时,删除最大的bitmap)
LimitedAgeMemoryCache (缓存对象超过定义的时间后删除)

 

3)缓存使用弱引用

WeakMemoryCache&＃xff08;没有限制缓存&＃xff09;

6、本地缓存模式可以使用以下已实现的方法 (ImageLoaderConfiguration.diskCache(...))

 

UnlimitedDiskCache 不限制缓存大小&＃xff08;默认&＃xff09;
TotalSizeLimitedDiskCache (设置总缓存大小&＃xff0c;超过时删除最久之前的缓存)
FileCountLimitedDiskCache (设置总缓存文件数量&＃xff0c;当到达警戒值时&＃xff0c;删除最久之前的缓存。如果文件的大小都一样的时候&＃xff0c;可以使用该模式)
LimitedAgeDiskCache (不限制缓存大小&＃xff0c;但是设置缓存时间&＃xff0c;到期后删除)

 

五、完美例子(参考
源码
)

1、项目结构图

Constans主要用来存放图片的url地址的

2、项目效果图

3、代码讲解

1)权限添加

 




 

2)初始化配置

 

package com.xwj.imageloaderdemo;
import java.io.File;
import android.app.Application;
import android.content.Context;
import com.nostra13.universalimageloader.cache.disc.impl.UnlimitedDiscCache;
import com.nostra13.universalimageloader.cache.disc.naming.Md5FileNameGenerator;
import com.nostra13.universalimageloader.cache.memory.impl.UsingFreqLimitedMemoryCache;
import com.nostra13.universalimageloader.core.ImageLoader;
import com.nostra13.universalimageloader.core.ImageLoaderConfiguration;
import com.nostra13.universalimageloader.core.assist.QueueProcessingType;
import com.nostra13.universalimageloader.core.download.BaseImageDownloader;
import com.nostra13.universalimageloader.utils.StorageUtils;
public class ImageLoaderApplication extends Application
public void onCreate()
super.onCreate();
initImageLoader(getApplicationContext());

public static void initImageLoader(Context context)
//缓存文件的目录
File cacheDir &＃61; StorageUtils.getOwnCacheDirectory(context, imageloader/Cache);
ImageLoaderConfiguration config &＃61; new ImageLoaderConfiguration.Builder(context)
.memoryCacheExtraOptions(480, 800) // max width, max height&＃xff0c;即保存的每个缓存文件的最大长宽
.threadPoolSize(3) //线程池内加载的数量
.threadPriority(Thread.NORM_PRIORITY - 2)
.denyCacheImageMultipleSizesInMemory()
.diskCacheFileNameGenerator(new Md5FileNameGenerator()) //将保存的时候的URI名称用MD5 加密
.memoryCache(new UsingFreqLimitedMemoryCache(2 * 1024 * 1024)) // You can pass your own memory cache implementation/你可以通过自己的内存缓存实现
.memoryCacheSize(2 * 1024 * 1024) // 内存缓存的最大值
.diskCacheSize(50 * 1024 * 1024) // 50 Mb sd卡(本地)缓存的最大值
.tasksProcessingOrder(QueueProcessingType.LIFO)
// 由原先的discCache -> diskCache
.diskCache(new UnlimitedDiscCache(cacheDir))//自定义缓存路径
.imageDownloader(new BaseImageDownloader(context, 5 * 1000, 30 * 1000)) // connectTimeout (5 s), readTimeout (30 s)超时时间
.writeDebugLogs() // Remove for release app
.build();
//全局初始化此配置
ImageLoader.getInstance().init(config);


注&＃xff1a;1.记得在
Android
Manifest.xml中添加android:name&＃61;com.xwj.imageloaderdemo.ImageLoaderApplication

 

2.自定义了缓存目录

3)初始化显示配置

 

// 使用DisplayImageOptions.Builder()创建DisplayImageOptions
options &＃61; new DisplayImageOptions.Builder()
.showImageOnLoading(R.drawable.ic_stub) // 设置图片下载期间显示的图片
.showImageForEmptyUri(R.drawable.ic_empty) // 设置图片Uri为空或是错误的时候显示的图片
.showImageOnFail(R.drawable.ic_error) // 设置图片加载或解码过程中发生错误显示的图片
.cacheInMemory(true) // 设置下载的图片是否缓存在内存中
.cacheOnDisk(true) // 设置下载的图片是否缓存在SD卡中
.displayer(new RoundedBitmapDisplayer(20)) // 设置成圆角图片
.build(); // 构建完成

 

4)显示图片

 

imageLoader.displayImage(imageUrls[position],
viewHolder.image, options);

 

5)清除缓存

 

public void onClearMemoryClick(View view)
Toast.makeText(this, 清除内存缓存成功, Toast.LENGTH_SHORT).show();
ImageLoader.getInstance().clearMemoryCache(); // 清除内存缓存


public void onClearDiskClick(View view)
Toast.makeText(this, 清除本地缓存成功, Toast.LENGTH_SHORT).show();
ImageLoader.getInstance().clearDiskCache(); // 清除本地缓存


 

其余是比较常规的代码&＃xff0c;就不多做介绍了